home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmStringNCopy.z / XmStringNCopy
Text File  |  1998-10-30  |  3KB  |  67 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSttttrrrriiiinnnnggggNNNNCCCCooooppppyyyy((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmSSSSttttrrrriiiinnnnggggNNNNCCCCooooppppyyyy((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmSSSSttttrrrriiiinnnnggggNNNNCCCCooooppppyyyy - A compound string function that creates a
  10.           copy of a compound string
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/Xm.h>
  14.           XXXXmmmmSSSSttttrrrriiiinnnngggg XXXXmmmmSSSSttttrrrriiiinnnnggggNNNNCCCCooooppppyyyy(
  15.           XXXXmmmmSSSSttttrrrriiiinnnngggg ssss1111,
  16.           iiiinnnntttt nnnnuuuummmm____bbbbyyyytttteeeessss);
  17.  
  18.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  19.           This page documents Motif 2.1.
  20.  
  21.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.           This function is obsolete and exists for compatibility with
  23.           previous releases.  XXXXmmmmSSSSttttrrrriiiinnnnggggNNNNCCCCooooppppyyyy creates a copy of _s_1 that
  24.           contains a specified number of bytes, including tags,
  25.           directional indicators, and separators. It then returns the
  26.           resulting compound string. The original strings are
  27.           preserved.  The function allocates space for the resulting
  28.           compound string.  The application is responsible for
  29.           managing the allocated space.  The application can recover
  30.           the allocated space by calling XXXXmmmmSSSSttttrrrriiiinnnnggggFFFFrrrreeeeeeee.
  31.  
  32.           _s_1        Specifies the compound string.
  33.  
  34.           _n_u_m__b_y_t_e_s Specifies the number of bytes of _s_1 to copy.  If
  35.                     this value is less than the length of _s_1, as many
  36.                     bytes as possible, but possibly fewer than this
  37.                     value, will be appended to _s_1 such that the
  38.                     resulting string is still a valid compound string.
  39.  
  40.      RRRREEEETTTTUUUURRRRNNNN
  41.           Returns a new compound string.
  42.  
  43.      RRRREEEELLLLAAAATTTTEEEEDDDD
  44.           XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeee(3) and XXXXmmmmSSSSttttrrrriiiinnnnggggFFFFrrrreeeeeeee(3).
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.